home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
User's Choice Windows CD
/
User's Choice Windows CD (CMS Software)(1993).iso
/
windows5
/
wmail220.zip
/
WMAIL.DOC
< prev
next >
Wrap
Text File
|
1992-01-10
|
71KB
|
2,538 lines
Window Mail
─────────────
Version 2.2 - January 1992
EchoMail Processor FTS compliant
(C) Copyright 1990-92 Silvan Calarco, FidoNet 2:334/100.2
Documentation by: Franco Schinco, FidoNet 2:334/100.0
WMail 2.2 - Copyright 1990-92 Silvan Calarco 01/10/92
INDEX
1. INTRODUCTION...............................................1
2. THANKS.....................................................1
3. LICENSE AGREEMENT..........................................2
4. INSTALLATION...............................................3
5. CONFIGURATION..............................................4
File.....................................................4
DOS Shell...........................................4
Write setup.........................................4
Write areas.........................................4
Write route.........................................4
Import areas........................................4
Exit................................................4
Global...................................................5
User - Sysop........................................5
User - Key..........................................5
Address - Main......................................5
Address - Aka 1-10..................................5
ZoneGate - Zonegate 1-10............................5
Directory - Mail....................................5
Directory - Files...................................5
Directory - Packets.................................6
Directory - ARCmail.................................6
Directory - MsgBase.................................6
Directory - DupPath.................................6
Directory - BadEcho.................................6
Directory - Packer..................................6
Directory - Stats...................................7
Directory - New areas...............................7
Directory - Nodelist................................7
Origin 1-10.........................................7
Manager..................................................7
Defaults - Put origin...............................7
Defaults - Put tear line............................7
Defaults - Hide seen-by.............................7
Defaults - Strip 4d.................................7
Defaults - Put domain...............................8
Packers - ARC.......................................8
Packers - ARJ.......................................8
Packers - LZH.......................................8
Packers - PAK.......................................8
Packers - ZIP.......................................8
Packers - ZOO.......................................8
Packers - ???.......................................8
Unpackers - ARC.....................................8
Unpackers - ARJ.....................................8
Unpackers - LZH.....................................8
Unpackers - PAK.....................................9
Unpackers - ZIP.....................................9
Unpackers - ZOO.....................................9
Nodes - Node........................................9
Nodes - Packer......................................9
Nodes - Packer Pw...................................9
Nodes - Areafix Pw..................................9
Nodes - Level.......................................9
Pag. i
WMail 2.2 - Copyright 1990-92 Silvan Calarco 01/10/92
Nodes - Aka..............................................9
Nodes - Daily pkts......................................10
Areas - Descr......................................10
Areas - Kind.......................................10
Areas - Tag........................................10
Areas - Dir........................................10
Areas - Level......................................10
Areas - Origin.....................................10
Areas - Flags - Put origin.........................10
Areas - Flags - Put tear line......................10
Areas - Flags - Hide seen-by.......................11
Areas - Flags - Strip 4d...........................11
Areas - Flags - Put domain.........................11
Areas - Aka........................................11
Areas - Frwd. 1-3..................................11
Misc....................................................11
General - Mailer...................................11
General - Fake net.................................11
General - Import dupes.............................11
General - Import bad...............................12
General - Stats....................................12
General - Log file.................................12
General - Minimum space............................12
General - Swap.....................................12
General - Use nodelist.............................12
General - Create areas.............................12
General - Honour RRRs..............................13
General - Link tear line...........................13
Log file - Log File................................13
Log file - Style...................................13
Log file - Level...................................13
Areafix - Kill msgs................................13
Areafix - Sort nodes...............................13
Areafix - Short form...............................13
Areafix - Rescan...................................13
Areafix - List file................................14
Pack - Kill msgs...................................14
Pack - Route file..................................14
6. EXECUTION.................................................15
7. FUNCTIONS DESCRIPTION.....................................16
8. USE OF WMAIL..............................................17
IMPORT..................................................17
EXPORT..................................................18
PACK....................................................19
SETMARK.................................................20
HIMARK..................................................20
WRITESTATS..............................................20
AREAFIX.................................................21
9. ROUTING...................................................22
Default routing.........................................22
System definitions......................................23
Routing commands........................................23
SCHEDULE ..........................................24
SEND-TO ...........................................24
HOLD ..............................................24
UNHOLD ............................................24
Pag. ii
WMail 2.2 - Copyright 1990-92 Silvan Calarco 01/10/92
ROUTE-TO ..........................................24
NO-ROUTE ..........................................24
ROUTE-FILES .......................................25
POLL ..............................................25
EXCEPT ............................................25
CHANGE ............................................25
LEAVE .............................................26
UNLEAVE ...........................................26
Specifications for node lists...........................26
Note about points.......................................26
Routing philosophy......................................27
Examples................................................27
10. HOW AREAFIX WORKS........................................29
11. TECHNICAL NOTES..........................................30
PKT with extended header................................30
Product Code............................................30
MSGID...................................................30
Dupes...................................................30
PID and Tear-line.......................................30
Illegal registration keys...............................30
Flag Truncate File Sent.................................30
Technical support.......................................31
Memory occupation.......................................31
ARCMail processing order................................31
Maximum message length..................................31
Execution errors........................................31
Limitations in unregistered copies......................31
Security................................................31
QuickBBS files sharing..................................32
Automatic creation of AREAS.BBS.........................32
ARCmail naming convention...............................32
12. EXAMPLES OF BATCH FILES..................................33
Pag. iii
WMail 2.2 - Copyright 1990-92 Silvan Calarco 01/10/92
1. INTRODUCTION
WMail is a brand new Echomail management program, for PC-based
system using mailers like Opus and BinkleyTerm, or FrontDoor and
D'Bridge.
Its main characteristics:
- supports Fido compatible message base
- supports QuickBBS compatible message base
- contains Pack function, for EchoMail and NetMail
- includes Areafix function
- point management, through FakeNet or with 4-dimension address
(FrontDoor madility only)
- creates EchoMail traffic statistics every week/month/year
- operates in FrontDoor manner or as Binkley and Opus
- windows (not Windows :-) ) graphic interface
- can have both Fido and QuickBBS areas formats in the same
areas file
- supports PassThru areas
- supports AKAs and ZoneGates
~~~~~~~~
This user manual relies on the knowledge of the basic functioning
concepts of a Bbs or a Point: for these things, you should read
the documentation included in the mailers used for EchoMail
transmission and in the Bbs management programs.
2. THANKS
I want to thank all Beta-Testers, who helped me very much in the
development of WMail: Ugo Uggetti, Andrea Mennini, Massimo
Gentilini, Marco Maccaferri, Cesare Dieni, Luca Leone, Roberto
Piola, Alberto Enna.
Special thanks are due to these people:
- Franco Schinco, victim of the first WMail trials on his
message base and author of this documentation.
- Franco Carcillo, who encouraged me very strongly to complete
the work.
- Maurizio Codogno, who wrote the coding algorithm for the
registration key and translated in English this documentation.
- Luca Leone, who gave me all kinds of technical infos about
FrontDoor functioning.
- Marcello Ardini, who gave me useful ideas to better manage
files.
- ....all ye that I forgot, and whom my most sincere Grazie! is
given.
Pag. 1
WMail 2.2 - Copyright 1990-92 Silvan Calarco 01/10/92
3. LICENSE AGREEMENT
WMail is neither Public Domain software nor Freeware: it is
distributes as Shareware. So, after a trial period, the user is
asked to registrate his/her copy sending the due amount of money
to the author.
Note that this version of WMail is not limited in lifetime: it
will continue to work even without registration. Nevertheless,
some secondary functions are only accessible after registrating
and receiving one key.
To registrate WMail it is necessary fill in and send to the
following address the form you can find in the distribution
archive; an amount of money is also required, to be sent through
a postal money order to the author.
The registration key is valid for this and all future versions of
WMail.
Everyone can redistribute WMail, provided that the original
archive is not changed in any way and no amount of money is
required. In no circostance at all WMail can be modified without
author's permission; it is prohibited too to include this
program, whole or in part, in other software. It is expressly
forbidden distribute the personal registration key to other
people.
WMail can be used in commercial organizations only after regular
registration.
This licence is considered accepted if the program is used: its
violation will involve the withdrawal of the registration key and
the rights to use the program.
No WMail source, of whichever of its version, will be ever
released.
In no case the author shall be liable for data loss or whatever
relative to WMail use; i.e., no guarantee at all is given about
program functioning, except that it occupies disk space.
Everyone who uses WMail and finds any functioning problem is
kindly asked to report them at Fidonet address 2:334/100.2 : time
permitting, everyoune will be answered.
Silvan Calarco, FidoNet 2:334/100.2
V. Leonardo da Vinci 177
10095 GRUGLIASCO (Torino)
ITALIA
Pag. 2
WMail 2.2 - Copyright 1990-92 Silvan Calarco 01/10/92
4. INSTALLATION
In WMail distributing archive the following files are contained:
WMAIL.EXE Executable program
WMAIL.OVR Overlay file
WMSETUP.EXE Configuration program
WMUPDATE.EXE Upgrade program from version 2.1
WNODE.EXE Nodelist compiler
WNODE.CTL Example of configuration file for WNode
WMAIL.DOC This documentation
REGISTER.FRM Registration form
HISTORY.DOC WMail previous versions
WMSTRUCT.220 Structures of the files used by WMail
WREM14.ZIP Window Remapper 1.4
README.1ST Note to upgrade from WMail 2.1
To install WMail:
1) Uncompact WMAIL.EXE , WMAIL.OVR , WMSETUP.EXE in the
directory where the current mailer is used.
2) Run the window setup WMSETUP.EXE and configurate WMail for
your system.
3) Correct or add in CONFIG.SYS the following line:
FILES=30 (for a point environment)
FILES=40 (for a Bbs environment)
4) Add in your AUTOEXEC.BAT file the following line:
SET WMAIL=path
where path is the directory where WMail searches for
the configuration file and memorizes dupes and statistics
files.
5) Modify the batch file of EchoMail processing, so that they
call WMail.
Pag. 3
WMail 2.2 - Copyright 1990-92 Silvan Calarco 01/10/92
5. CONFIGURATION
WMail gets the informations needed to know system configuration
from a file called WMAIL.PRM, located in the directory pointed by
the WMAIL system variable. This file is created from
WMSETUP.EXE .
Areas definition is instead taken from AREAS.PRM, used by WEdit
1.3 or greater too. WmSetup & WMail will look for AREAS.PRM in
the directory pointed by the WMAIL system variable; if not found,
il will be searched in the WEDIT system variable.
Use of WMSETUP.EXE
It is possible to specify different filenames for configuration
file and areas file using the following switches on the
command-line:
-Pfilename (for configuration file. Default: WMAIL.PRM)
-Afilename (for areas file. Default: AREAS.PRM)
File
* DOS Shell
Allows to spawn a shell and temporarily leave WMSETUP.EXE .
* Write setup
Writes the present configuration in a text file.
* Write areas
Writes all defined areas in a AREAS.BBS style file.
* Write route
Writes a sample routing file for a point environment.
* Import areas
Imports AREAS.BBS file in AREAS.PRM .
* Exit
Exits WMSETUP.EXE and saves WMAIL.PRM & AREAS.PRM .
Pag. 4
WMail 2.2 - Copyright 1990-92 Silvan Calarco 01/10/92
Global
* User - Sysop
Specifies name (and surname) which will be substituted in
NetMail inbound messages addresses to `Sysop'.
* User - Key
Specifies registration key number; if your WMail version is
not registered, leave blank this field.
* Address - Main
Specifies the primary address associated to node or point. If
you do not have such, DO NOT invent it! Ask rather one to the
Net coordinator nearest to you. A fake or non-standard node
number can cause serious problems to Echomail distribution
network.
* Address - Aka 1-10
Specifies all secondary matrix addresses, if assigned. Akas
will be used also to recognize addresses sent to `Areafix'.
* ZoneGate - Zonegate 1-10
Specifies the forward node, which is a gate to a different
zone with respect to the one specified in Node instruction.
All SEEN-BYs from messages passed to ZoneGate will be
stripped off.
* Directory - Mail
Specifies the path in which WMail will put MetMail inbound
messages and will create attach messages for FrontDoor, if it
is working in this manner. Final backslash can be omitted.
* Directory - Files
Specifies the path in which WMail will search for FrontDoor
and .PKT files to elaborate in input phase. Final backslash
can be omitted.
Pag. 5
WMail 2.2 - Copyright 1990-92 Silvan Calarco 01/10/92
* Directory - Packets
Specifies path in which .PKT files to be compacted in Export
phase are created. It also specifies the path in which .OUT
files are put, which will be further elaborated by PACK
function, if WMail is start in that way. If WMail is used in
FrontDoor modality, it is best to use a ramdisk: in this way
execution time is greatly reduced. Final backslash can be
omitted.
* Directory - ARCmail
Specifies path in which ARCmail files created during Export
phase will be stored. This instruction is only needed if
WMail is used in environments which a packer is not required,
e.g. with D'Bridge or FrontDoor.
PLEASE NOTE: If WMail is used in Binkley modality (so
that .OUT files are created for further
elaboration with PACK), this field must remain
blank.
Final backslash can be omitted.
* Directory - MsgBase
Specifies the path in which WMail creates MSG*.BBS files,
relative to QuickBBS data base. This instruction is only
necessary if such areas are specified in AREAS.PRM . Final
backslash can be omitted.
* Directory - DupPath
Specifies the path in which dupe messages are put. If not
specified, these messages will be deleted during Import
phase. Final backslash can be omitted.
* Directory - BadEcho
Specifies the path in which messages with bad data, relative
to areas not present in AREAS.PRM or coming from nodes not
listed in AREAS.PRM are put. If unspecified, these messages
will be deleted during Import phase. Final backslash can be
omitted.
* Directory - Packer
Specifies the path in which WMail searches for packers and
unpackers. Final backslash can be omitted.
Pag. 6
WMail 2.2 - Copyright 1990-92 Silvan Calarco 01/10/92
* Directory - Stats
Specifies the path in which WMail creates statistics files.
If unspecified, the current directory will be used. Final
backslash can be omitted.
* Directory - New areas
Specifies the path from which subdirectories relatives to
areas with tag not present in areas file will be created, if
new Fido areas creation is set. Final backslash can be
omitted.
* Directory - Nodelist
Specifies the path of nodelist files created from WNode.
Final backslash can be omitted.
* Origin 1-10
Specifies a set of lines to be inserted as Origin in EchoMail
messages who don't have it.
NOTE: no control is made to check if this content plus
FidoNet address, which WMail automatically inserts,
exceed 79 characters.
Manager
* Defaults - Put origin
If set to `Yes' all new areas will have the `Put origin' flag
set to `Yes'.
* Defaults - Put tear line
If set to `Yes' all new areas will have the `Put tear line'
flag set to `Yes'.
* Defaults - Hide seen-by
If set to `Yes' all new areas will have the `Hide seen-by'
flag set to `Yes'.
* Defaults - Strip 4d
If set to `Yes' all new areas will have the `Strip 4d' flag
set to `Yes'.
Pag. 7
WMail 2.2 - Copyright 1990-92 Silvan Calarco 01/10/92
* Defaults - Put domain
If set to `Yes' all new areas will have the `Put domain' flag
set to `Yes'.
* Packers - ARC
Defines name and command-line parameters of ARC packer.
* Packers - ARJ
Defines name and command-line parameters of ARJ packer.
* Packers - LZH
Defines name and command-line parameters of LZH packer.
* Packers - PAK
Defines name and command-line parameters of PAK packer.
* Packers - ZIP
Defines name and command-line parameters of ZIP packer.
* Packers - ZOO
Defines name and command-line parameters of ZOO packer.
* Packers - ???
Defines name and command-line parameters of a user-defined
packer.
* Unpackers - ARC
Defines name and command-line parameters of ARC unpacker.
* Unpackers - ARJ
Defines name and command-line parameters of ARJ unpacker.
* Unpackers - LZH
Defines name and command-line parameters of LZH unpacker.
Pag. 8
WMail 2.2 - Copyright 1990-92 Silvan Calarco 01/10/92
* Unpackers - PAK
Defines name and command-line parameters of PAK unpacker.
* Unpackers - ZIP
Defines name and command-line parameters of ZIP unpacker.
* Unpackers - ZOO
Defines name and command-line parameters of ZOO unpacker.
* Nodes - Node
Specifies node for which packer, Areafix password and Areafix
level are declared.
* Nodes - Packer
Allows to select which packer, among those above declared,
should be used for that node in Export and Pack phases.
* Nodes - Packer Pw
Specifies the optional command and password to be sent to the
packer.
* Nodes - Areafix Pw
Specifies password which that node will have to use when
sending messages to Areafix.
* Nodes - Level
Specifies the level of the node with respect to Areafix: a
node can change areas file only for those areas whose level
is less than or equal to the one specified in this field.
* Nodes - Aka
Specifies wich AKA, among those above declared, is to be used
to communicate with current node.
Pag. 9
WMail 2.2 - Copyright 1990-92 Silvan Calarco 01/10/92
* Nodes - Daily pkts
Specifies if WMail must create an ARCMail file for every day
or continue adding to the existing one, if any.
* Areas - Descr.
Specifies area description.
* Areas - Kind
Specifies the kind of area: Local, NetMail, EchoMail or
Passthru. Local and NetMail areas are ingnored by WMail.
* Areas - Tag
Specifies the tag of the area.
* Areas - Dir
Specifies the path or msgbase board for the current area.
* Areas - Level
Specifies the level of the area with respect to Areafix
function.
* Areas - Origin
Allows to select which origin, among those above declared,
should be used for this area.
* Areas - Flags - Put origin
If set to `Yes', WMail during Export phase will always
substitute the possible origin found in the message with the
selected one.
* Areas - Flags - Put tear line
If set to `Yes', WMail during Export phase will always
substitute the possible tearline found in the message with
the selected one.
Pag. 10
WMail 2.2 - Copyright 1990-92 Silvan Calarco 01/10/92
* Areas - Flags - Hide seen-by
If set to `Yes', WMail will hide in imported messages Seen-by
lines preceding them with a ^A.
* Areas - Flags - Strip 4d
If set to `Yes', WMail will not insert in PATH line
three-dimension addresses to indicate points.
* Areas - Flags - Put domain
If set to `Yes', WMail will insert domain in message origin
line.
* Areas - Aka
Specifies Aka and domain to be used in present area.
* Areas - Frwd. 1-3
Specify the nodes, in sequence as in a AREAS.BBS line, to
which export current area.
Misc
* General - Mailer
Specifies the modality WMail will operate in: BinkleyTerm,
FrontDoor (also known as ARCmail modality).
* General - Fake net
Specifies fakenet used to individuate points: during Export
phase, WMail will remove all SEEN-BYs relative to nodes with
net equal to the declared one, to avoid conflicts with
official nodes of a net. In this way, points can be managed
in a compatible way with EchoMail processors which cannot
recognize 4-dimension address. WMail is so able to manage
both modalities. This instruction has to be used both on
Bossnode and on the point which uses fake address.
* General - Import dupes
If set to `Yes', WMail will put in the declared directory
dupe messages; they will be otherwise deleted during
Import phase.
Pag. 11
WMail 2.2 - Copyright 1990-92 Silvan Calarco 01/10/92
* General - Import bad
If set to `Yes', WMail will put in the declared directory
messages corrupted, relative to areas not present in
areas definition or coming from nodes not listed in Frwd. 1-3
field of area; they will be otherwise deleted during Import
phase.
* General - Stats
If set to `Yes', WMail will generate monthly/weekly/yearly
statistics.
* General - Log file
If set to `Yes', WMail will create a logfile.
* General - Minimum space
Specifies minimum space (in KBytes) on disk, under which
WMail will make no operation.
* General - Swap
Specifies whether and how swap should be performed during
packing and unpacking:
EMS : swap on expanded memory
Disk : swap on disk
No : no swap
If EMS swap was specified and there is not enough EMS
present, swap will be made on disk, anyway.
* General - Use nodelist
If set to `Yes', WMail will use nodelist to indicate names of
BBSes to which it is exporting messages.
* General - Create areas
Specifies whether or not WMail would create subdirectories
(or use unused QuickBBS msgbase boards) to areas with tags
not present in areas definition, and found during import.
Pag. 12
WMail 2.2 - Copyright 1990-92 Silvan Calarco 01/10/92
* General - Honour RRRs
Specifies whether or not WMail would reply to NetMail
messages with Return Receipt Request flag set.
* General - Link tear line
If set to 'Yes' WMail will add its tear line to the existing
one in the following way: Tl1+' & '+Tl2 .
* Log file - Log File
Specifies logfile name used by WMail.
* Log file - Style
Specifies logfile writing style:
FrontDoor : logfile style like FrontDoor
BinkleyTerm : logfile style like BinkleyTerm
* Log file - Level
Indicates how much information should be reported in logfile.
* Areafix - Kill msgs.
If set to `Yes', WMail will delete messages to Areafix after
processing them.
* Areafix - Sort nodes
If set to `Yes', WMail will sort nodes in Frwd. 1-3 field of
areas definition during AREAS.PRM rewriting.
* Areafix - Short form
If set to `Yes', WMail will use in Frwd. 1-3 fields of areas
definition the short address form: for example, 334/100 101
102 instead 334/100 334/101 334/102 .
* Areafix - Rescan
Specifies if user-requests areas rescan is allowed.
Pag. 13
WMail 2.2 - Copyright 1990-92 Silvan Calarco 01/10/92
* Areafix - List file
Specifies the file sent together with the answer file when
Areafix message has switch -L .
* Pack - Kill msgs.
If set to `Yes', WMail will kill messages with `In transit'
flag after sending them, if mailer did not make it.
* Pack - Route file
Specifies the routing file name to be used in PACK function.
Pag. 14
WMail 2.2 - Copyright 1990-92 Silvan Calarco 01/10/92
6. EXECUTION
WMail has 7 main functions : IMPORT
EXPORT
PACK
SETMARK
HIMARK
WRITESTATS
AREAFIX
General syntax is : WMail <function> [switches]
For each function, a help screen is available by digiting:
WMail <function> ?
Pag. 15
WMail 2.2 - Copyright 1990-92 Silvan Calarco 01/10/92
7. FUNCTIONS DESCRIPTION
-- IMPORT Function --
Unpacks received ARCmail and puts messages from .PKT in the
appropriate areas.
-- EXPORT Function --
Prepares .PKT with outbound messages and packs them as ARCmail.
-- PACK Function --
Packs NetMail messages together with EchoMail ones and sets
routing of the created files.
-- SETMARK Function --
Sets High Water Mark (flag of last elaborated message) at
specified message (only for Fido format areas).
-- HIMARK Function --
Sets High Water Mark at last message present in area (only for
Fido format areas).
-- WRITESTATS Function --
Creates statistics files about Echomail traffic.
-- AREAFIX Function --
Manages areas file (AREAS.PRM) in an automatic way.
Pag. 16
WMail 2.2 - Copyright 1990-92 Silvan Calarco 01/10/92
8. USE OF WMAIL
The following is a description of all switches allowed in the
various functions.
-- IMPORT
WMail will automatically choose the unpacker to be used for the
various ARCmail packets.
Unpackers *must* be found in the Global - Directory - Packer path
set in WMSETUP.EXE .
Syntax : WMAIL IMPORT [switches]
-Afile : Use file 'file' as areas file instead of
AREAS.PRM
-D : Deletes messages without text part.
-E : Exports messages to all other nodes.
-Ffile : Create file `file' with the name of the
areas in which messages came.
-I : Import from BadEcho
-Pfile : Use file 'file' as configuration file
instead of WMAIL.PRM
-Q : Quiet mode; minimizes output information
to video.
-S : Sets up security.
If some area is in Quickbbs format, it is advisable to use -E
switch to speed Export procedure.
Pag. 17
WMail 2.2 - Copyright 1990-92 Silvan Calarco 01/10/92
-- EXPORT
Syntax : WMAIL EXPORT [switches]
-Afile : Use file 'file' as areas file instead of
AREAS.PRM
-Ffile : Forces WMail to scan only areas with tag
specified in `file'.
-Pfile : Use file 'file' as configuration file
instead of WMAIL.PRM
-Q : Quiet mode; minimizes output information
to video.
-R : Exports private messages as NetMail.
-S : Forces scan of the whole QuickBBS
message base. If present, ECHOMAIL.BBS
is deleted.
Pag. 18
WMail 2.2 - Copyright 1990-92 Silvan Calarco 01/10/92
-- PACK
Syntax : WMAIL PACK [switches]
-Afile : Use file 'file' as areas file instead of
AREAS.PRM
-N : Forces WMail not to compress packets
generated.
-Pfile : Use file 'file' as configuration file
instead of WMAIL.PRM
-Q : Quiet mode; minimizes output information
to video.
-Stag : Executes schedule `tag' from routing
file. WMail by default reads schedule
'@'.
Pag. 19
WMail 2.2 - Copyright 1990-92 Silvan Calarco 01/10/92
-- SETMARK
Syntax : WMAIL SETMARK dir num_msg
dir : Area path.
num_msg : number of message where HWM is to be moved.
-- HIMARK
Syntax : WMAIL HIMARK dir
dir : Area path.
-- WRITESTATS
Syntax : WMAIL WRITESTATS [switches]
-Afile : Use file 'file' as areas file instead of
AREAS.PRM
-Y : Creates statistics file only for current
year.
-M : Creates statistics file only for current
month.
-Pfile : Use file 'file' as configuration file
instead of WMAIL.PRM
-W : Creates statistics file only for current
week.
Pag. 20
WMail 2.2 - Copyright 1990-92 Silvan Calarco 01/10/92
-- AREAFIX
Syntax : WMAIL AREAFIX ADD node area1 area2 ... [switches]
WMAIL AREAFIX DEL node area1 area2 ... [switches]
WMAIL AREAFIX FIND node [switches]
WMAIL AREAFIX EC [switches]
│ ADD : Add node (Net/Node.Point) to stated areas.
│
│ DEL : Delete node from stated areas.
│
│ EC : Process NetMail messages addresses to
│ Areafix and updates areas file.
│
│ FIND : List areas hooked to specified node.
-Afile : Use file 'file' as areas file instead of
AREAS.PRM
-C : Set Crash bit in answer messages.
-H : Set Hold bit in answer messages.
-K : Set Kill/Sent bit in answer messages.
-Pfile : Use file 'file' as configuration file
instead of WMAIL.PRM
-Q : Quiet mode; minimizes output information
to video.
Pag. 21
WMail 2.2 - Copyright 1990-92 Silvan Calarco 01/10/92
9. ROUTING
Routing determinates the kind of packets prepared from WMail
during PACK phase, and nodes to which they will be sent. Note
that a wrong routing procedure can cause calls not scheduled by
mailer; be therefore careful about the structure of routing file
and mailer events.
Global routing commands are those which appear before every
SCHEDULE declaration in route file. These are always used, so it
is possible to specify situations identical for each event.
Local routing commands are those which appear between two
SCHEDULE declaration in route file. WMail determinates which
`block' of commands is to be used, by searching for the schedule
corresponding to the letter specified with -S switch in command
line. If no letter is specified, WMail search by default `@'
schedule.
Every line starting with a semicolon is considered a comment.
Addresses specified in routing file can be written in short form,
by using declaration ALL. To list several systems in a net, it is
sufficient to specify net number for the first declared node.
Routing language is completely case insensitive: SEND, send, and
SenD are considered the same command.
-- Default routing
WMail has some default rules for routing; they will be used if no
other rule is specified for a particular message. Some of default
rules cannot be substituted by routing commands.
■ Messages with crash, direct and hold flags set will
not be routed towards other nodes. In Binkley modality they
will never be packed as ARCmail; they will be exported as
*.?UT packets.
■ Only normal messages, with no crash, direct and hold flags,
are packed as ARCmail and respect routing rules. In Binkley
modality *.?LO attack files are created.
■ In binkley modality orphan ARCmail packets are always sent to
destination node.
■ Messages with received, orphan, lock or sent flags are always
ignored by WMail.
■ In FrontDoor modality, file attacks, file requests and
IMMediate messages are ignored by WMail.
Pag. 22
WMail 2.2 - Copyright 1990-92 Silvan Calarco 01/10/92
-- System definitions
It is possible to define a system, by putting a SEND-TO command
in the global section of the routing file, but this is not always
suitable. SEND-TO, POLL and the list SEND-LIST after a schedule
command are the only ways to declare a system to exchange mail.
Messages to nodes non present in these declaration are ignored.
-- Routing commands
WMail routing can be done in two different ways:
* In FrontDoor compatibility, by using the same routing file and
by creating a file attack message for packed mail. This is the
default. Note that to mantain compatibility, user should avoid
to use any verb.
* In Binkley compatibility, by using extended commands in
routing file, and by creating files NNNNnnnn.?LO in case of
file attach, NNNNnnnn.?UT for unpacked packets and
NNNNnnnn.REQ for file requests. Packets for zone other than
the default one, will be put in directory outbound.zzz, where
'outbound' is outgoing packets directory, and zzz is the hex
destination zone number (E.g. If you are in zone 2 and your
outbound subdirectory is C:\Outbound, packets for zone 39 will
be put in C:\Outbound.027).
In the following commands, VERB declarations are optional and
useful for the operations in Binkley modality, and include these
commands:
Verb Extension of created files
---- --------------------------
NORMAL FLO or OUT
CRASH CLO or CUT
HOLD HLO or HUT
DIRECT DLO or DUT
EXPRESS CUT
For the meaning of these declarations, please refer to
BinkleyTerm manual, as they are used by this mailer.
In Binkley compatibility, it is possible to tell WMail NOT to
pack outbound mail, by putting -N switch in the command line.
In the following, the routing file commands are presented:
Pag. 23
WMail 2.2 - Copyright 1990-92 Silvan Calarco 01/10/92
SCHEDULE <TAG> [VERB] [SEND-LIST]
Defines the start of a command block. All commands following a
schedule declaration are considered in the same block, until
another schedule declaration or the end of file.
TAG is an alphanumeric character. Each character can be used in
at most a tag.
Optional parameter VERB, used in Binkley modality, specifies the
kind of file .?LO or .?UT which will be created for nodes
specified in SEND-LIST.
Optional parameter SEND-LIST contains systems concerned by
schedule.
SEND-TO [VERB] <SEND-LIST>
Defines the systems listed in SEND-LIST which receive mail in the
way specified by VERB. VERB and SEND-LIST options are similar to
those in SCHEDULE declaration.
HOLD <LIST>
Keep mail for specified systems. It is the equivalent of the
command SEND-TO HOLD <SEND-LIST>. Hold mail is not sent, unless
the receiving node makes a call.
UNHOLD <LIST>
The opposite of HOLD. It is useful in case of global declaration
in HOLD command, if one or mode nodes should be excluded by the
effect of the command.
ROUTE-TO [VERB] <TARGET> <LIST>
Route mail (except file attach messages) for nodes specifies in
LIST to node specified in TARGET. In Binkley modality, VERB sets
the way in which mail must be created for TARGET node.
NO-ROUTE <LIST>
Sends directly mail to nodes specified. This command can be used
to negate effect of ROUTE-TO to one or more nodes, in case of
global declarations.
Pag. 24
WMail 2.2 - Copyright 1990-92 Silvan Calarco 01/10/92
ROUTE-FILES [VERB] <TARGET> <LIST>
Routes file attach messages (but not the standard mail) of nodes
specified in LIST to node specified in TARGET. Destination node
must know of it in order for file attach to work; it is therefore
necessary to ask that node's Sysop if he or she lets files be
routed through his/her system.
POLL [VERB] <LIST>
Forces mailer to call systems specified even if no other mail
addressed to them is present. This command, used in FrontDoor
modality, is equivalent to SEND-TO, as it is the mailer who calls
concerned nodes, while if used in Binkley modality fake files are
created, according to VERB parameter:
Verb Fake POLL file
---- --------------
NORMAL NNNNnnnn.OUT
CRASH NNNNnnnn.CUT
HOLD NNNNnnnn.HUT
DIRECT NNNNnnnn.DUT
EXPRESS NNNNnnnn.CUT
N.B. In Binkley modality it is necessary that files present in
LIST don't contain global declarations (ALL or *).
EXCEPT <LIST>
Specifies exceptions to the list of nodes, in the above commands.
Multiple EXCEPT lines are supported. EXCEPT statements always
follow a command and can be put either after this command or in a
new line. E.g."ROUTE-TO 334/100 * EXCEPT 334/101"
N.B.: The following commands are useful only in Binkley modality:
-----------------------------------------------------------------
CHANGE <TO-VERB> <LIST>
Changes the way in which packets are sent, by modifying
extensions of .?LO and .?UT files for nodes present in LIST, on
the basis of TO-VERB parameter.
For example, CHANGE HOLD 1/1 would have the following effect:
00010001.?LO --> 00010001.HLO
00010001.?UT --> 00010001.HUT
Pag. 25
WMail 2.2 - Copyright 1990-92 Silvan Calarco 01/10/92
LEAVE <LIST>
LEAVE command makes unavailable for mailers the packets already
created for nodes present in LIST, by changing their extension.
This is useful to avoid sending of mail to a calling node during
some events. This command is similar to FrontDoor's DENY, which
is however useless with WMail, as it is managed by mailer. Files
are renamed in this way:
NNNNnnnn.?UT --> NNNNnnnn.N?T
NNNNnnnn.?LO --> NNNNnnnn.N?O
UNLEAVE <LIST>
UNLEAVE command renames again packets whose name was changed by
LEAVE command, restoring the original extension. Files are
renamed in this way:
NNNNnnnn.N?T --> NNNNnnnn ?UT
NNNNnnnn.N?O --> NNNNnnnn ?LO
-- Specifications for node lists
It is possible to use a number of different formats to specify a
list of systems in routing commands:
ALL All systems.
2:ALL All systems in zone 2.
2:334/ALL All systems in zone 2, net 334.
2:334/1 101 102 2:334/1 2:334/101 and 2:334/102.
.1 .2 .3 .4 .5 Own points 1, 2, 3, 4 and 5.
NOTE: Instead of ALL it can be used a star `*'.
To mantain compatibility with FrontDoor 2.x the use of `*'
is strictly necessary.
-- Note about points
Points from other systems are always treated as their boss.
Systems can send mail only to other nodes and to its own points.
In Binkley modality 4 dimensions points are not allowed yet;
fake-address method should be used.
Pag. 26
WMail 2.2 - Copyright 1990-92 Silvan Calarco 01/10/92
-- Routing philosophy
* Commands are interpreted sequentially, so that any statement
can be modified by the next ones. E.g.:
SEND-TO DIRECT 334/100
SEND-TO CRASH 334/100
Messages are sent to 334/100 as CRASH. In its internal reasoning
WMail first flags messages for 334/100 as DIRECT, and then as
CRASH.
* When you use ROUTE-TO and ROUTE-FILES commands, remember to
exclude all nodes which are not to be routed, as they have
effect in any position of Global and Local routing. E.g.:
ROUTE-TO 334/100 332/400
SEND-TO CRASH 332/400
The second statement has no effect, as after first line all
messages addressed 332/400 are considered for 334/100.
ROUTE-TO 334/100 * EXCEPT 332/400
SEND-TO DIRECT 332/400
NO-ROUTE 332/400
ROUTE-TO 334/100 *
In these two cases messages will not be routed to 332/400.
-- Examples
* Example 1: a Binkley system with points (fakenet is 22402)
SCHEDULE @ NORMAL ALL ; This schedule looks at all
; nodes and sends by default
; messages as NORMAL
SEND-TO HOLD 22402/* 332/305
SEND-TO CRASH 332/309 334/100
ROUTE-TO DIRECT 332/404 *
EXCEPT 334/100 332/309 332/305 22402/*
All message will be routed to 332/404 except for specified
nodes. Messages for points and for 332/305 will be flagged as
HOLD. Messages for 332/309 and 334/100 will be flagged as
CRASH.
Pag. 27
WMail 2.2 - Copyright 1990-92 Silvan Calarco 01/10/92
* Example 2: a FrontDoor system with 4 dimensions points
ROUTE-TO 2:334/0 2:* ; Send all zone 2 messages to 2:334/0
; except for points messages
ROUTE-TO 2:33/999 * ; Send all other zones messages to
; 2:33/999
HOLD * ; Holds all messages
SCHEDULE A 334/101 ; Look only at messages for 334/101
NO-ROUTE 334/101 ; Do not route messages for 334/101
POLL 334/101 ; but call the system everyday.
SCHEDULE B 2:* ; Look at all messages
UNHOLD 2:33/999 ; Unhold messages for 2:33/999
DENY 334/100.* ; Prevent points from picking up mail
* Example 3: a Binkley point system (created by WMSetup)
SCHEDULE @ DIRECT *
ROUTE-TO DIRECT 2:334/100 *
1st line is used to qualify system to send mail everywhere
2nd line is used to send all netmail to boss system
Pag. 28
WMail 2.2 - Copyright 1990-92 Silvan Calarco 01/10/92
10. HOW AREAFIX WORKS
The automatic management of areas file is accomplished by means
of NetMail messages sent to "Areafix"; in the message subject it
must be put the password assigned to the node which sent the
message. The message text must contain the list of areas, one
for each line and starting in column 1, to be added or deleted.
The character `-' (minus) before the area tag means that that
areas should be deleted. Message text ends with a line containing
a triple dash `---'.
For ex.
From : Silvan Calarco of 2:334/100.2
To : Areafix of 2:334/100.0
Subj : My_Password
________________________________________________________________
MSD_HARD.ITA
-CLANG.ITA
---
The previous message instruct WMail to add to Silvan Calarco's
node, to which password `My_password' was assigned, area
MSD_HARD.ITA, while area CLANG.ITA will be deleted.
If in subject there is a `-L' after the password (separated by a
blank), WMail will send to the node the list of EchoMail areas
for which adding is allowed. If -Q is used instead, areas list
will be sent as a message.
If in subject there is a `-R' a rescan of added areas will be
done, so that old messages will be forwarded too.
Note that rescan will not work for QuickBBS areas, if they have
already been scanned for export.
Pag. 29
WMail 2.2 - Copyright 1990-92 Silvan Calarco 01/10/92
11. TECHNICAL NOTES
* PKT with extended header
WMail generates type 2 PKTs, with extended header, according to
standard proposed by Joaquim Homrighausen and adopted by Chris
Irwin too, for D'Bridge. In the new header structure, zone
provenance and destination of PKT and origin and destination
point are included. By looking at product code contained in PKTs,
WMail can recognize if software which generated that PKT supports
extended header, and in affirmative case gets informations to
process messages.
Please, write to the author if you know of any program that
generates type 2 PKTs which are not recognized by WMail.
* Product Code
The present WMail product code is 0x77 (119 dec).
* MSGID
WMail inserts MSGID in messages which lack of it.
* Dupes
Maximum number of dupes managed by WMail per area is 1000.
* PID and Tear-line
If during export -T switch is used, WMail will add after its
identificative "WMail 2.2" the number of registration key; if
the switch is not used, it will put at the start of the message
and hidden with a ^A a line of Product Information (PID) with the
same informations.
* Illegal registration keys
WMail will not import messages whose tear-line or PID contains a
key similar to the one specified in WMAIL.PRM. It is therefore
impossible to use key assigned to other copies.
* Flag Truncate File Sent
In attach messages for ARCmail, WMail inserts TFS kludge, so that
FrontDoor and compatible mailers truncate to length 0 the file
just sent.
Pag. 30
WMail 2.2 - Copyright 1990-92 Silvan Calarco 01/10/92
* Technical support
An ECHO conference on node 2:334/100.0 is activated, with tag
WMAIL.334 and dedicated to W* products; to hook it, please
contact SysOp of 2:334/100.0
* Memory occupation
Thanks to its capability to swap code on disk or EMS during
external programs (packer and unpacker) execution, WMail can run
in about 280 Kb. Overlay file is loaded in EMS, if it is
present.
* ARCMail processing order
To process ARCmai and PKTs Dos file date is used to determine
which packet is to be imported first.
* Maximum message length
The maximum length of a message is virtually infinite: messages
longer than available memory are split by WMail in more parts.
* Execution errors
In case of run-time error, WMail will create a file WMAILERR.LOG
in which date, time and kind of the error are reported.
* Limitations in unregistered copies
If WMail is used without a registration key, function Areafix,
weekly/monthly statistics, nodelist use, new areas creation and
Return Receipt messages will not be operative. Yearly statistics
will work.
* Security
WMail will put messages from PKTs with destination different from
the address specified in Node or Akas in directory BadEcho. If
switch -S is present in IMPORT functions, EchoMail messages
coming from nodes not present in areas file will be put in
BadEcho too.
To import messages from BadEcho area switch -I must be specified
on command line.
To force WMail to import wrong addressed PKTs, it is necessary to
specify in WMSETUP, as AKA, the address reported in the logfile
as 'Wrong address'.
Pag. 31
WMail 2.2 - Copyright 1990-92 Silvan Calarco 01/10/92
* QuickBBS files sharing
WMail will lock message base file access during Import phase.
* Automatic creation of AREAS.BBS
WMSETUP is able to create an AREAS.BBS compatible file in batch
execution too.
Run: WMSETUP WriteAreas filename
* ARCmail naming convention
Interzone or destined to points ARCmail files have name
Paaaccc.ext, where:
- P is a constant character
- aaa is the most significant number between destpoint,origpoint
and destzone in hex format.
- cccc is a CRC-32 of the two complete addresses (origin and
destination)
- ext is the standard extension according to FTS-0018 .
Pag. 32
WMail 2.2 - Copyright 1990-92 Silvan Calarco 01/10/92
12. EXAMPLES OF BATCH FILES
1) Bbs : Opus
Mailer : BinkleyTerm
Rem File Batch to use WMail with Opus and BinkleyTerm
Rem -------------------------------------------------
Rem
:Start
Bt
If Errorlevel 200 Goto Export
If Errorlevel 24 Goto 2400_Baud
If Errorlevel 12 Goto 1200_Baud
If Errorlevel 10 Goto Import
If Errorlevel 3 Goto 300_Baud
If Errorlevel 1 Goto End
Goto Start
:2400_Baud
Opus Bbs -b2400
Goto Start
:1200_Baud
Opus Bbs -b1200
Goto Start
:300_Baud
Opus Bbs -b300
Goto Start
:Import
WMail Import
WRemap
Goto Start
:Export
Wmail Export
WMail Pack
Goto Start
:End
Echo Bbs OffLine !
Pag. 33
WMail 2.2 - Copyright 1990-92 Silvan Calarco 01/10/92
2) Bbs : QuickBBS
Mailer : BinkleyTerm
Rem File Batch to use WMail with QuickBBS and BinkleyTerm
Rem -----------------------------------------------------
Rem
:Start
Bt
If Errorlevel 200 Goto Export
If Errorlevel 24 Goto 2400_Baud
If Errorlevel 12 Goto 1200_Baud
If Errorlevel 10 Goto Import
If Errorlevel 3 Goto 300_Baud
If Errorlevel 1 Goto End
Goto Start
:2400_Baud
QuickBBS -B2400
Goto Start
:1200_Baud
QuickBBS -B1200
Goto Start
:300_Baud
QuickBBS -B300
Goto Start
:Import
WMail Import
WRemap
MbUtil Import
Goto Start
:Export
Wmail Export -S
MbUtil Export
WMail Pack
Goto Start
:End
Echo Bbs OffLine !
Pag. 34
WMail 2.2 - Copyright 1990-92 Silvan Calarco 01/10/92
3) Bbs : Opus
Mailer : FrontDoor
Rem File Batch to use WMail con Opus and FrontDoor
Rem --------------------------------------------------
Rem
:Start
Fd
If Errorlevel 240 Goto 2400_Baud
If Errorlevel 200 Goto Export
If Errorlevel 120 Goto 1200_Baud
If Errorlevel 100 Goto Import
If Errorlevel 31 Goto 300_Baud
If Errorlevel 10 Goto End
Goto Start
:2400_Baud
Opus Bbs -b2400
Goto Start
:1200_Baud
Opus Bbs -b1200
Goto Start
:300_Baud
Opus Bbs -b300
Goto Start
:Import
WMail Import
WRemap
Goto Start
:Export
Wmail Export
Goto Start
:End
Echo Bbs OffLine !
Pag. 35
WMail 2.2 - Copyright 1990-92 Silvan Calarco 01/10/92
4) Bbs : QuickBBS
Mailer : FrontDoor
Rem File Batch to use WMail with QuickBBS and FrontDoor
Rem ---------------------------------------------------
Rem
:Start
Fd
If Errorlevel 240 Goto 2400_Baud
If Errorlevel 200 Goto Export
If Errorlevel 120 Goto 1200_Baud
If Errorlevel 100 Goto Import
If Errorlevel 31 Goto 300_Baud
If Errorlevel 10 Goto End
Goto Start
:2400_Baud
QuickBBS -B2400
Goto Start
:1200_Baud
QuickBBS -B1200
Goto Start
:300_Baud
QuickBBS -B300
Goto Start
:Import
WMail Import
WRemap
MbUtil Import
Goto Start
:Export
Wmail Export -S
MbUtil Export
Goto Start
:End
Echo Bbs OffLine !
Pag. 36
WMail 2.2 - Copyright 1990-92 Silvan Calarco 01/10/92
5) Bbs : Opus and QuickBBS
Mailer : FrontDoor
Rem File Batch to use WMail with areas in Opus and QuickBBS
Rem format with FrontDoor
Rem -------------------------------------------------------
Rem
:Start
Fd
If Errorlevel 240 Goto 2400_Baud
If Errorlevel 200 Goto Export
If Errorlevel 120 Goto 1200_Baud
If Errorlevel 100 Goto Import
If Errorlevel 31 Goto 300_Baud
If Errorlevel 10 Goto End
Goto Start
:2400_Baud
QuickBBS -B2400
Goto Start
:1200_Baud
QuickBBS -B1200
Goto Start
:300_Baud
QuickBBS -B300
Goto Start
:Import
WMail Import
WRemap
MbUtil Import
Goto Start
:Export
Wmail Export -S
MbUtil Export
Goto Start
:End
Echo Bbs OffLine !
---------
Opus, BinkleyTerm, FrontDoor and D'Bridge are trademark of their
respective authors.
** End of Documentation **
Pag. 37